home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / pmlogger.z / pmlogger
Encoding:
Text File  |  2002-10-03  |  31.5 KB  |  528 lines

  1.  
  2.  
  3.  
  4. PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))                                                        PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmllllooooggggggggeeeerrrr - create archive log for performance metrics
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      $$$$PPPPCCCCPPPP____BBBBIIIINNNNAAAADDDDMMMM____DDDDIIIIRRRR////ppppmmmmllllooooggggggggeeeerrrr [----cccc _c_o_n_f_i_g_f_i_l_e] [----hhhh _h_o_s_t] [----llll _l_o_g_f_i_l_e] [----LLLL] [----nnnn
  13.      _p_m_n_s_f_i_l_e] [----PPPP] [----rrrr] [----ssss _e_n_d_s_i_z_e] [----tttt _i_n_t_e_r_v_a_l] [----TTTT _e_n_d_t_i_m_e] [----vvvv _v_o_l_s_i_z_e]
  14.      [----VVVV _v_e_r_s_i_o_n] [----xxxx _f_d] _a_r_c_h_i_v_e
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      ppppmmmmllllooooggggggggeeeerrrr creates the archive logs of performance metric values that may
  18.      be ``played back'' by other Performance Co-Pilot (see PPPPCCCCPPPPIIIInnnnttttrrrroooo(1)) tools.
  19.      These logs form the basis of the VCR paradigm and retrospective
  20.      performance analysis services common to the PCP toolkit.
  21.  
  22.      The mandatory argument _a_r_c_h_i_v_e is the base name for the physical files
  23.      that constitute an archive log.
  24.  
  25.      The ----VVVV option specifies whether a version 1 or version 2 archive is
  26.      generated.  A version 2 archive also stores the associated Performance
  27.      Metrics Name Space (PMNS). By default a version 2 archive is generated.
  28.  
  29.      Unless directed to another host by the ----hhhh option, ppppmmmmllllooooggggggggeeeerrrr will contact
  30.      the Performance Metrics Collector Daemon (PMCD) on the local host and use
  31.      that as the source of the metric values to be logged.
  32.  
  33.      To support the required flexibility and control over what is logged and
  34.      when, ppppmmmmllllooooggggggggeeeerrrr maintains an independent two level logging state for each
  35.      instance of each performance metric.  At the first (mandatory) level,
  36.      logging is allowed to be oooonnnn (with an associated interval between
  37.      samples), or ooooffffffff or mmmmaaaayyyybbbbeeee.  In the latter case, the second (advisory)
  38.      level logging is allowed to be oooonnnn (with an associated interval between
  39.      samples), or ooooffffffff.
  40.  
  41.      The mandatory level allows universal specification that some metrics must
  42.      be logged, or must nnnnooootttt be logged.  The default state for all instances of
  43.      all metrics when ppppmmmmllllooooggggggggeeeerrrr starts is mandatory maybe and advisory off.
  44.  
  45.      Use ppppmmmmllllcccc(1) to interrogate and change the logging state once ppppmmmmllllooooggggggggeeeerrrr is
  46.      running.
  47.  
  48.      If a metric's state is mandatory (on or off) and a request is made to
  49.      change it to mandatory maybe, the new state is mandatory maybe and
  50.      advisory off.  If a metric's state is already advisory (on or off) and a
  51.      request is made to change it to mandatory maybe, the current state is
  52.      retained.
  53.  
  54.      It is not possible for ppppmmmmllllooooggggggggeeeerrrr to log specific instances of a metric and
  55.      all instances of the same metric concurrently.  If specific instances are
  56.      being logged and a request to log all instances is made, then all
  57.      instances of the metric will be logged according to the new request,
  58.      superseding any prior logging request for the metric.  A request to log
  59.      all instances of a metric will supersede any previous request to log all
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))                                                        PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))
  71.  
  72.  
  73.  
  74.      instances.  A request to log specific instances of a metric when all
  75.      instances are already being logged is refused.  To do this one must turn
  76.      off logging for all instances of the metric first.  In each case, the
  77.      validity of the request is checked first; for example a request to change
  78.      a metric's logging state to advisory on when it is currently mandatory
  79.      off is never permitted (it is necessary to change the state to mandatory
  80.      maybe first).
  81.  
  82.      Optionally, each system running ppppmmmmccccdddd(1) may also be configured to run a
  83.      ``primary'' ppppmmmmllllooooggggggggeeeerrrr instance.  Like ppppmmmmccccdddd(1), this ppppmmmmllllooooggggggggeeeerrrr instance is
  84.      launched by $$$$PPPPCCCCPPPP____RRRRCCCC____DDDDIIIIRRRR////ppppccccpppp, and is affected by the files
  85.      /_e_t_c/_c_o_n_f_i_g/_p_m_l_o_g_g_e_r (use cccchhhhkkkkccccoooonnnnffffiiiigggg(1M) to activate or disable the
  86.      primary ppppmmmmllllooooggggggggeeeerrrr instance), /_e_t_c/_c_o_n_f_i_g/_p_m_l_o_g_g_e_r._o_p_t_i_o_n_s (command line
  87.      options passed to the primary ppppmmmmllllooooggggggggeeeerrrr) and
  88.      $_P_C_P__V_A_R__D_I_R/_c_o_n_f_i_g/_p_m_l_o_g_g_e_r/_c_o_n_f_i_g._d_e_f_a_u_l_t (the default initial
  89.      configuration file for the primary ppppmmmmllllooooggggggggeeeerrrr).
  90.  
  91.      The primary ppppmmmmllllooooggggggggeeeerrrr instance is identified by the ----PPPP option.  There may
  92.      be at most one ``primary'' ppppmmmmllllooooggggggggeeeerrrr instance on each system with an
  93.      active ppppmmmmccccdddd(1).  The primary ppppmmmmllllooooggggggggeeeerrrr instance (if any) must be running
  94.      on the same host as the ppppmmmmccccdddd(1) to which it connects, so the ----hhhh and ----PPPP
  95.      options are mutually exclusive.
  96.  
  97.      When launched as a non-primary instance, ppppmmmmllllooooggggggggeeeerrrr will exit immediately
  98.      if the configuration file causes no metric logging to be scheduled.  The
  99.      ----LLLL option overrides this behavior, and causes a non-primary ppppmmmmllllooooggggggggeeeerrrr
  100.      instance to ``linger'', presumably pending some future dynamic re-
  101.      configuration and state change via ppppmmmmllllcccc(1).  ppppmmmmllllooooggggggggeeeerrrr will also linger
  102.      without the ----LLLL option being used if all the metrics to be logged are
  103.      logged as once only metrics. When the once only metrics have been logged,
  104.      a warning message will be generated stating that the event queue is empty
  105.      and no more events will be scheduled.
  106.  
  107.      By default all diagnostics and errors from ppppmmmmllllooooggggggggeeeerrrr are written to the
  108.      file _p_m_l_o_g_g_e_r._l_o_g in the directory where ppppmmmmllllooooggggggggeeeerrrr is launched.  The ----llll
  109.      option may be used to override the default behavior.  If the log file
  110.      cannot be created or is not writable, output is written to standard error
  111.      instead.
  112.  
  113.      If specified, the ----ssss option instructs ppppmmmmllllooooggggggggeeeerrrr to terminate after a
  114.      certain size in records, bytes or time units has been accumulated. If
  115.      _e_n_d_s_i_z_e is an integer then _e_n_d_s_i_z_e records will be written to the log.
  116.      If _e_n_d_s_i_z_e is suffixed by bbbb or bbbbyyyytttteeeessss then _e_n_d_s_i_z_e bytes of the archive
  117.      data will be written out (note, however, that archive log record
  118.      boundaries will not be broken and so this limit may be slightly
  119.      surpassed).  Other viable file size units include:  KKKK, KKKKbbbb, KKKKiiiilllloooobbbbyyyytttteeee for
  120.      kilobytes and MMMM, MMMMbbbb, MMMMeeeeggggaaaabbbbyyyytttteeee for megabytes.  These units may be
  121.      optionally suffixed by an ssss and may be of mixed case.  Alternatively
  122.      _e_n_d_s_i_z_e may be suffixed using a time unit as described in PPPPCCCCPPPPIIIInnnnttttrrrroooo(1) for
  123.      the _i_n_t_e_r_v_a_l argument (to the standard PCP tool option ----tttt).
  124.      Some examples of different formats:
  125.           ----ssss 111100000000
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))                                                        PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))
  137.  
  138.  
  139.  
  140.           ----ssss 111100000000bbbbyyyytttteeeessss
  141.           ----ssss 111100000000KKKK
  142.           ----ssss 111100000000MMMMbbbb
  143.           ----ssss 11110000mmmmiiiinnnnssss
  144.           ----ssss 11110000hhhhoooouuuurrrrssss
  145.      The default is for ppppmmmmllllooooggggggggeeeerrrr to run forever.
  146.  
  147.      The ----rrrr option causes the size of the physical record(s) for each group of
  148.      metrics and the expected contribution of the group to the size of the PCP
  149.      archive for one full day of collection to be reported in the log file.
  150.      This information is reported the first time each group is successfully
  151.      written to the archive.
  152.  
  153.      The log file is potentially a multi-volume data set, and the ----vvvv option
  154.      causes ppppmmmmllllooooggggggggeeeerrrr to start a new volume after a certain size in records,
  155.      bytes, or time units has been accumulated for the current volume.  The
  156.      format of this size specification is identical to that of the ----ssss option
  157.      (see above).  The default is for ppppmmmmllllooooggggggggeeeerrrr to create a single volume log.
  158.      Additional volume switches can also be forced asynchronously by either
  159.      using ppppmmmmllllcccc(1) or sending ppppmmmmllllooooggggggggeeeerrrr a SIGHUP signal (see below). Note, if a
  160.      scheduled volume switch is in operation due to the ----vvvv option, then its
  161.      counters will be reset after an asynchronous switch.
  162.  
  163.      Normally ppppmmmmllllooooggggggggeeeerrrr operates on the distributed Performance Metrics Name
  164.      Space (PMNS), however if the ----nnnn option is specified an alternative local
  165.      PMNS is loaded from the file _p_m_n_s_f_i_l_e.
  166.  
  167.      Under normal circumstances, ppppmmmmllllooooggggggggeeeerrrr will run forever (except for a ----ssss
  168.      option or a termination signal).  The ----TTTT option may be used to limit the
  169.      execution time using the format of time as prescribed by PPPPCCCCPPPPIIIInnnnttttrrrroooo(1).
  170.      Some examples of different formats:
  171.           ----TTTT 11110000mmmmiiiinnnnssss
  172.           ----TTTT ''''@@@@ 11111111::::33330000''''
  173.      From this it can be seen that ----TTTT 11110000mmmmiiiinnnnssss and ----ssss 11110000mmmmiiiinnnnssss perform identical
  174.      actions.
  175.  
  176.      When ppppmmmmllllooooggggggggeeeerrrr receives a SIGHUP signal, the current volume of the log is
  177.      closed, and a new volume is opened.  This mechanism (or the alternative
  178.      mechanism via ppppmmmmllllcccc(1)) may be used to manage the growth of the log files
  179.      - once a log volume is closed, that file may be archived without ill-
  180.      effect on the continued operation of ppppmmmmllllooooggggggggeeeerrrr.  See also the ----vvvv option
  181.      above.
  182.  
  183.      The buffers for the current log may be flushed to disk using the fffflllluuuusssshhhh
  184.      command of ppppmmmmllllcccc(1), or by sending ppppmmmmllllooooggggggggeeeerrrr a SIGUSR1 signal.  This is
  185.      useful when the log needs to be read while ppppmmmmllllooooggggggggeeeerrrr is still running.
  186.  
  187.      When launched with the ----xxxx option, pmlogger will accept asynchronous
  188.      control requests on the file descriptor _f_d.  This option is only expected
  189.      to be used internally by PCP applications that support ``live record
  190.      mode'' via ppppmmmmRRRReeeeccccoooorrrrddddCCCCoooonnnnttttrrrroooollll(3).
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))                                                        PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))
  203.  
  204.  
  205.  
  206. CCCCOOOONNNNFFFFIIIIGGGGUUUURRRRAAAATTTTIIIIOOOONNNN FFFFIIIILLLLEEEE SSSSYYYYNNNNTTTTAAAAXXXX
  207.      The configuration file may be specified with the ----cccc option.  If it is
  208.      not, configuration specifications are read from standard input.
  209.  
  210.      If _c_o_n_f_i_g_f_i_l_e does not exist, then a search is made in the directory
  211.      $_P_C_P__V_A_R__D_I_R/_c_o_n_f_i_g/_p_m_l_o_g_g_e_r for a file of the same name, and if found
  212.      that file is used, e.g. if _c_o_n_f_i_g._m_u_m_b_l_e does not exist in the current
  213.      directory and the file $_P_C_P__V_A_R__D_I_R/_c_o_n_f_i_g/_p_m_l_o_g_g_e_r/_c_o_n_f_i_g._m_u_m_b_l_e does
  214.      exist, then ----cccc ccccoooonnnnffffiiiigggg....mmmmuuuummmmbbbblllleeee and ----cccc
  215.      $$$$PPPPCCCCPPPP____VVVVAAAARRRR____DDDDIIIIRRRR////ccccoooonnnnffffiiiigggg////ppppmmmmllllooooggggggggeeeerrrr////ccccoooonnnnffffiiiigggg....mmmmuuuummmmbbbblllleeee are equivalent.
  216.  
  217.      The syntax for the configuration file is as follows.
  218.  
  219.      1.   Words are separated by white space (space, tab or newline).
  220.  
  221.      2.   The symbol ``#'' (hash) introduces a comment, and all text up to the
  222.           next newline is ignored.
  223.  
  224.      3.   Keywords (shown in bbbboooolllldddd below) must appear literally (i.e. in lower
  225.           case).
  226.  
  227.      4.   Each specification begins with the optional keyword lllloooogggg, followed by
  228.           one of the states mmmmaaaannnnddddaaaattttoooorrrryyyy oooonnnn, mmmmaaaannnnddddaaaattttoooorrrryyyy ooooffffffff, mmmmaaaannnnddddaaaattttoooorrrryyyy mmmmaaaayyyybbbbeeee,
  229.           aaaaddddvvvviiiissssoooorrrryyyy oooonnnn or aaaaddddvvvviiiissssoooorrrryyyy ooooffffffff.
  230.  
  231.      5.   For the oooonnnn states, a logging interval must follow using the syntax
  232.           ``oooonnnncccceeee'', or ``ddddeeeeffffaaaauuuulllltttt'', or ``eeeevvvveeeerrrryyyy _N _t_i_m_e_u_n_i_t_s'', or simply ``_N
  233.           _t_i_m_e_u_n_i_t_s'' - _N is an unsigned integer, and _t_i_m_e_u_n_i_t_s is one of the
  234.           keywords mmmmsssseeeecccc, mmmmiiiilllllllliiiisssseeeeccccoooonnnndddd, sssseeeecccc, sssseeeeccccoooonnnndddd, mmmmiiiinnnn, mmmmiiiinnnnuuuutttteeee, hhhhoooouuuurrrr or the
  235.           plural form of one of the above.
  236.           Internal limitations require the interval to be smaller than
  237.           (approximately) 74 hours.  An interval value of zero is a synonym
  238.           for oooonnnncccceeee.  An interval of ddddeeeeffffaaaauuuulllltttt means to use the default logging
  239.           interval of 60 seconds; this default value may be changed to
  240.           _i_n_t_e_r_v_a_l with the ----tttt command line option.
  241.  
  242.           The _i_n_t_e_r_v_a_l argument follows the syntax described in PPPPCCCCPPPPIIIInnnnttttrrrroooo(1),
  243.           and in the simplest form may be an unsigned integer (the implied
  244.           units in this case are seconds).
  245.  
  246.      6.   Following the state and possible interval specifications comes a
  247.           ``{'', followed by a list of one or more metric specifications and a
  248.           closing ``}''.  The list is white space (or comma) separated.  If
  249.           there is only one metric specification in the list, the braces are
  250.           optional.
  251.  
  252.      7.   A metric specification consists of a metric name optionally followed
  253.           by a set of instance names.  The metric name follows the standard
  254.           PCP naming conventions, see ppppmmmmnnnnssss(4), and if the metric name is a
  255.           non-leaf node in the PMNS (see ppppmmmmnnnnssss(4)), then ppppmmmmllllooooggggggggeeeerrrr will
  256.           recursively descend the PMNS and apply the logging specification to
  257.           all descendent metric names that are leaf nodes in the PMNS.  The
  258.  
  259.  
  260.                                                                         PPPPaaaaggggeeee 4444
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267. PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))                                                        PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))
  268.  
  269.  
  270.  
  271.           set of instance names is a ``['', followed by a list of one or more
  272.           space (or comma) separated names, numbers or strings, and a closing
  273.           ``]''.  Elements in the list that are numbers are assumed to be
  274.           internal instance identifiers, other elements are assumed to be
  275.           external instance identifiers - see ppppmmmmGGGGeeeettttIIIInnnnDDDDoooommmm(3) for more
  276.           information.
  277.  
  278.           If no instances are given, then the logging specification is applied
  279.           to all instances of the associated metric.
  280.  
  281.      8.   There may be an arbitrary number of logging specifications.
  282.  
  283.      9.   Following all of the logging specifications, there may be an
  284.           optional access control section, introduced by the literal token
  285.           [[[[aaaacccccccceeeessssssss]]]].  Thereafter come access control rules of the form ``aaaalllllllloooowwww
  286.           _h_o_s_t_l_i_s_t :::: _o_p_e_r_a_t_i_o_n ;;;;'' and ``ddddiiiissssaaaalllllllloooowwww _h_o_s_t_l_i_s_t :::: _o_p_e_r_a_t_i_o_n ;;;;''.
  287.  
  288.           The base _o_p_e_r_a_t_i_o_n_s are aaaaddddvvvviiiissssoooorrrryyyy, mmmmaaaannnnddddaaaattttoooorrrryyyy and eeeennnnqqqquuuuiiiirrrreeee.  In all
  289.           other aspects, these access control statements follow the syntactic
  290.           and semantic rules defined for the access control mechanisms used by
  291.           PMCD and are fully documented in ppppmmmmccccdddd(1).
  292.  
  293. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  294.      For each PCP utility, there is a sample ppppmmmmllllooooggggggggeeeerrrr configuration file that
  295.      could be used to create an archive log suitable for replaying with that
  296.      tool (i.e. includes all of the performance metrics used by the tool).
  297.      For a tool named _f_o_o this configuration file is located in
  298.      $_P_C_P__V_A_R__D_I_R/_c_o_n_f_i_g/_p_m_l_o_g_g_e_r/_c_o_n_f_i_g._f_o_o.
  299.  
  300.      The following is a simple default configuration file for a primary
  301.      ppppmmmmllllooooggggggggeeeerrrr instance, and demonstrates most of the capabilities of the
  302.      configuration specification language.
  303.  
  304.           log mandatory on once { hinv.ncpu hinv.ndisk }
  305.           log mandatory on every 10 minutes {
  306.               disk.all.write
  307.               disk.all.read
  308.               network.interface.in.packets [ "et0" ]
  309.               network.interface.out.packets [ "et0" ]
  310.               nfs.server.reqs [ "lookup" "getattr" "read" "write" ]
  311.           }
  312.  
  313.           log advisory on every 30 minutes {
  314.               environ.temp
  315.               pmcd.pdu_in.total
  316.               pmcd.pdu_out.total
  317.           }
  318.  
  319.           [access]
  320.           disallow * : all except enquire;
  321.           allow localhost : mandatory, advisory;
  322.  
  323.  
  324.  
  325.  
  326.                                                                         PPPPaaaaggggeeee 5555
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333. PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))                                                        PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))
  334.  
  335.  
  336.  
  337. AAAAUUUUTTTTOOOOMMMMAAAATTTTIIIICCCC RRRREEEESSSSTTTTAAAARRRRTTTT
  338.      It is often useful for ppppmmmmllllooooggggggggeeeerrrr processes (other than the primary
  339.      instance) to be started and stopped when the local host is booted or
  340.      shutdown.  The script $_P_C_P__R_C__D_I_R/_p_c_p_l_o_c_a_l and the necessary soft-links
  341.      are provided, and can be modified by rrrrooooooootttt to run PCP tools automatically.
  342.      If you want to find out more before starting, read the manual pages for
  343.      rrrrcccc2222(1), rrrrcccc0000(1), sssshhhhuuuuttttddddoooowwwwnnnn(1) and the file /_e_t_c/_i_n_i_t._d/_R_E_A_D_M_E.
  344.  
  345.      For example, changing $_P_C_P__R_C__D_I_R/_p_c_p_l_o_c_a_l so that it contains:
  346.  
  347.          # Add startup actions here
  348.          ($PCP_BINADM_DIR/pmlogger_check &)
  349.          ;;
  350.  
  351.          # Add shutdown actions here
  352.          killall -INT pmlogger
  353.          ;;
  354.  
  355.      will start ppppmmmmllllooooggggggggeeeerrrr instances at boot time and terminate them in an
  356.      orderly fashion at system shutdown.
  357.  
  358.      This script runs as rrrrooooooootttt, so any _p_m_l_o_g_g_e_r instances it launches are also
  359.      run as rrrrooooooootttt.  To run some ppppmmmmllllooooggggggggeeeerrrr instances as a particular user, create
  360.      your own archive logger control file (see ppppmmmmllllooooggggggggeeeerrrr____cccchhhheeeecccckkkk(1)) and use the
  361.      ssssuuuu(1) command. e.g.
  362.  
  363.          # Add startup actions here
  364.          (su tanya -c "$PCP_BINADM_DIR/pmlogger_check -c /usr/people/tanya/ctl" &)
  365.          ;;
  366.  
  367.      at boot time will start the ppppmmmmllllooooggggggggeeeerrrr instances described in
  368.      /_u_s_r/_p_e_o_p_l_e/_t_a_n_y_a/_c_t_l, running as user ttttaaaannnnyyyyaaaa.
  369.  
  370. FFFFIIIILLLLEEEESSSS
  371.      _a_r_c_h_i_v_e....mmmmeeeettttaaaa
  372.                metadata (metric descriptions, instance domains, etc.) for the
  373.                archive log
  374.      _a_r_c_h_i_v_e....0000 initial volume of metrics values (subsequent volumes have
  375.                suffixes 1111, 2222, ...)
  376.      _a_r_c_h_i_v_e....iiiinnnnddddeeeexxxx
  377.                temporal index to support rapid random access to the other
  378.                files in the archive log
  379.      $$$$PPPPCCCCPPPP____TTTTMMMMPPPP____DDDDIIIIRRRR////ppppmmmmllllooooggggggggeeeerrrr
  380.                ppppmmmmllllooooggggggggeeeerrrr maintains the files in this directory as the map
  381.                between the process id of the ppppmmmmllllooooggggggggeeeerrrr instance and the IPC
  382.                port that may be used to control each ppppmmmmllllooooggggggggeeeerrrr instance (as
  383.                used by ppppmmmmllllcccc(1))
  384.      ////eeeettttcccc////ccccoooonnnnffffiiiigggg////ppppmmmmllllooooggggggggeeeerrrr
  385.                cccchhhhkkkkccccoooonnnnffffiiiigggg(1M) control flag, to control launching of ppppmmmmllllooooggggggggeeeerrrr
  386.                from $$$$PPPPCCCCPPPP____RRRRCCCC____DDDDIIIIRRRR////ppppccccpppp
  387.  
  388.  
  389.  
  390.  
  391.  
  392.                                                                         PPPPaaaaggggeeee 6666
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399. PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))                                                        PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))
  400.  
  401.  
  402.  
  403.      ////eeeettttcccc////ccccoooonnnnffffiiiigggg////ppppmmmmllllooooggggggggeeeerrrr....ooooppppttttiiiioooonnnnssss
  404.                command line options to ppppmmmmllllooooggggggggeeeerrrr when launched from
  405.                $$$$PPPPCCCCPPPP____RRRRCCCC____DDDDIIIIRRRR////ppppccccpppp
  406.      $$$$PPPPCCCCPPPP____VVVVAAAARRRR____DDDDIIIIRRRR////ccccoooonnnnffffiiiigggg////ppppmmmmllllooooggggggggeeeerrrr////ccccoooonnnnffffiiiigggg....ddddeeeeffffaaaauuuulllltttt
  407.                default configuration file for the primary logger instance
  408.                launched from $$$$PPPPCCCCPPPP____RRRRCCCC____DDDDIIIIRRRR////ppppccccpppp
  409.      $$$$PPPPCCCCPPPP____VVVVAAAARRRR____DDDDIIIIRRRR////ccccoooonnnnffffiiiigggg////ppppmmmmllllooooggggggggeeeerrrr////ccccoooonnnnffffiiiigggg....*
  410.                assorted configuration files suitable for creating logs that
  411.                may be subsequently replayed with the PCP visualization and
  412.                monitoring tools
  413.      $$$$PPPPCCCCPPPP____LLLLOOOOGGGG____DDDDIIIIRRRR////ppppmmmmllllooooggggggggeeeerrrr_h_o_s_t_n_a_m_e
  414.                Default directory for PCP archive files for performance metric
  415.                values collected from the host _h_o_s_t_n_a_m_e.
  416.      ./_p_m_l_o_g_g_e_r._l_o_g
  417.                (or $$$$PPPPCCCCPPPP____LLLLOOOOGGGG____DDDDIIIIRRRR////ppppmmmmllllooooggggggggeeeerrrr////_h_o_s_t_n_a_m_e////ppppmmmmllllooooggggggggeeeerrrr....lllloooogggg when started
  418.                automatically by either $$$$PPPPCCCCPPPP____RRRRCCCC____DDDDIIIIRRRR////ppppccccpppp or one of the
  419.                ppppmmmmllllooooggggggggeeeerrrr(1) monitoring scripts such as ppppmmmmllllooooggggggggeeeerrrr____cccchhhheeeecccckkkk(1))
  420.                all messages and diagnostics are directed here
  421.      $$$$PPPPCCCCPPPP____RRRRCCCC____DDDDIIIIRRRR////ppppccccppppllllooooccccaaaallll
  422.                contains ``hooks'' to enable automatic restart at system boot
  423.                time
  424.  
  425. EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  426.      Normally ppppmmmmllllooooggggggggeeeerrrr creates a socket to receive control messages from
  427.      ppppmmmmllllcccc(1) on the first available TCP/IP port numbered 4330 or higher.  The
  428.      environment variable PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR____PPPPOOOORRRRTTTT may be used to specify an alternative
  429.      starting port number.
  430.  
  431. PPPPCCCCPPPP EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  432.      Environment variables with the prefix PPPPCCCCPPPP____ are used to parameterize the
  433.      file and directory names used by PCP.  On each installation, the file
  434.      /_e_t_c/_p_c_p._c_o_n_f contains the local values for these variables.  The
  435.      $$$$PPPPCCCCPPPP____CCCCOOOONNNNFFFF variable may be used to specify an alternative configuration
  436.      file, as described in ppppccccpppp....ccccoooonnnnffff(4).
  437.  
  438. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  439.      PPPPCCCCPPPPIIIInnnnttttrrrroooo(1), ppppmmmmccccdddd(1), ppppmmmmdddduuuummmmpppplllloooogggg(1), ppppmmmmllllcccc(1), ppppmmmmllllooooggggggggeeeerrrr____cccchhhheeeecccckkkk(1),
  440.      ppppccccpppp....ccccoooonnnnffff(4), ppppccccpppp....eeeennnnvvvv(4) and ppppmmmmnnnnssss(4).
  441.  
  442.      If you have the PCP product, relevant information is also available from
  443.      the on-line PCP Tutorial.  Provided the ppppccccpppp....mmmmaaaannnn....ttttuuuuttttoooorrrriiiiaaaallll subsystem from
  444.      the PCP images has been installed, access the URL
  445.      ffffiiiilllleeee::::$$$$PPPPCCCCPPPP____DDDDOOOOCCCC____DDDDIIIIRRRR////TTTTuuuuttttoooorrrriiiiaaaallll////aaaarrrrcccchhhhiiiivvvveeee....hhhhttttmmmmllll from your web browser.
  446.  
  447. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  448.      The archive logs are sufficiently precious that ppppmmmmllllooooggggggggeeeerrrr will not
  449.      truncate an existing physical file.  A message of the form
  450.       __pmLogNewFile: "foo.index" already exists, not over-written
  451.       __pmLogCreate: File exists
  452.      indicates this situation has arisen.  You must explicitly remove the
  453.      files and launch ppppmmmmllllooooggggggggeeeerrrr again.
  454.  
  455.  
  456.  
  457.  
  458.                                                                         PPPPaaaaggggeeee 7777
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465. PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))                                                        PPPPMMMMLLLLOOOOGGGGGGGGEEEERRRR((((1111))))
  466.  
  467.  
  468.  
  469.      There may be at most one primary ppppmmmmllllooooggggggggeeeerrrr instance per monitored host;
  470.      attempting to bend this rule produces the error:
  471.       pmlogger: there is already a primary pmlogger running
  472.  
  473.      Various other messages relating to the creation and/or deletion of files
  474.      in $_P_C_P__T_M_P__D_I_R/_p_m_l_o_g_g_e_r suggest a permission problem on this directory,
  475.      or some feral files have appeared therein.
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.                                                                         PPPPaaaaggggeeee 8888
  525.  
  526.  
  527.  
  528.